<?php

    #-------------------------------------------------------------#
	# This file is part of the Tekuna MVC Microframework for PHP. #
	# (c) 2009 Niels Jäckel <niels.jaeckel@tekuna.org>            #
	# Please visit http://tekuna.org/ for more information.       #
	#                                                             #
	# This software is licensed under the MIT License. Please     #
	# view the LICENSE file for the full text of this license.    #
    #-------------------------------------------------------------#


	/**
	 * Interface for logging classes
	 */

	interface TekunaLogger {

		/**
		 * Create a new logger class for the given file name
		 *
		 * @param string $sFileName the logging file name
		 */

		public function __construct($sFileName);


		/**
		 * @return the current file name
		 */

		public function getFileName();


		/**
		 * set a new file name
		 *
		 * @param string $sFileName the new file name
		 */

		public function setFileName($sFileName);


		/**
		 * Log the given message into the file on a new line.
		 * The current date and time are prepended automatically.
		 *
		 * @param string $sMessage the log message
		 */

		public function log($sMessage);


		/**
		 * return the content of the current log file in a
		 * pre-parsed array format. Each line is represented by
		 * a new entry in the array. Each entry is an array again
		 * that holds the following two keys: date, message. The
		 * date is not parsed into a unix timestamp and comes in
		 * the stored raw format.
		 *
		 * @return array the data array
		 */

		public function getLogData();
	}
